home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / MIDIFIND.DOC < prev    next >
Text File  |  1997-03-09  |  5KB  |  152 lines
  1.         ******************************
  2.             MIDIFIND v1.2
  3.     
  4.             search words in midi files
  5.               by Guenter Nagler 
  6.                 1995 
  7.           (gnagler@ihm.tu-graz.ac.at)
  8.         ******************************
  9.  
  10. [1] BACKGROUND
  11. When using my utility MIDI2TXT you get full textual representation 
  12. of a midi file. So someone can read the comments in a midi file 
  13. with this program. I were often interested in finding out who has 
  14. written a very good midi to thank the person who sequenced it.
  15. Then I was interested in finding out if one of other midi files
  16. was written by the same author. MIDI2TXT was too slow to do this 
  17. searching because of overhead of notes that are converted into text 
  18. format.    This led me to program MIDIFIND that I can search in the text/lyric
  19. of midi files.
  20.  
  21. [2] FILES DESCRIPTION
  22.  
  23. MIDIFIND.EXE..........MSDOS executable for midi search
  24. MIDIFIND.DOC..........this file, showing usage of MIDIFIND.EXE
  25. MIDIFIND.CPP..........C++ source code for midifind (DOS/UNIX)
  26. only MIDIFIND.EXE is required to run program 
  27.  
  28. [3] COPYRIGHT
  29.  
  30. MIDIFIND (c) 1995 was created by Guenter Nagler.
  31.  
  32. MIDIFIND is free and may be used as you wish with this one exception:
  33.  
  34.     You may NOT charge any fee or derive any profit for distribution
  35.     of MIDIFIND.  Thus, you may NOT sell or bundle MIDIFIND with any 
  36.     product in a retail environment (shareware disk distribution, CD-ROM,
  37.     etc.) without permission of the author.
  38.  
  39. You may give MIDIFIND to your friends, upload it to a BBS, or ftp it to
  40. another internet site, as long as you don't charge anything for it.
  41.  
  42. [4] DISCLAIMER
  43.  
  44. MIDIFIND was designed to search text in standard midifiles.
  45. It searches for midi meta events that contain text only.
  46.  
  47. Use MIDIFIND at your own risk.  Anything you do with MIDIFIND is your
  48. responsibility, and not the author's.  Any damage caused to any person,
  49. computer, software, hardware, company, or business by running MIDIFIND 
  50. is your responsibility, and the author will not be liable.
  51.  
  52. If you don't understand these terms, or are not sure of something, or
  53. are afraid something bad might come of using MIDIFIND, don't  use  it!
  54. You are here forewarned.
  55.  
  56. [5] INSTALLATION 
  57.  
  58. [MSDOS]
  59.  
  60.   Simply copy MIDIFIND.EXE in a directory that is in your path.
  61.   When you start the program without arguments
  62.  
  63.   C:\> MIDIFIND
  64.  
  65.   you should get the usage text (see next section)
  66.  
  67. [UNIX]
  68. compile sources with your C++ compiler (e.g. GNU Compiler g++):
  69.  
  70. g++ -o midifind midifind.cpp
  71.  
  72. and run program
  73.  
  74. $ midifind
  75.  
  76. [6] USAGE
  77.  
  78. usage: MIDIFIND search [file.mid ...]
  79.  
  80. search is the word or simple regular expression (*, ?, # as wildcard)
  81. that should be searched in following file names.
  82.  
  83. wildcards for search:
  84. *    matches 0 or more characters
  85. ?    matches exactly one character
  86. #    matches exactly one digit 0-9
  87.  
  88. UNIX: These characters are used by system and therefore you need
  89.  to escape them (use 'run*train'  or run\*train )!
  90.  
  91. search is caseinsensitive (upper letters are treated as lower letters).
  92.  
  93. Filenames can contain wildcards (DOS: * and ?,  
  94. UNIX: system wildcards *, ?, [...] etc).
  95. If no filename is specified then *.mid is assumed (only in dos systems).
  96.  
  97. [7] OUTPUT MESSAGES
  98.  
  99. When the search expression is not found in any of the midi files then
  100. MIDIFIND stops without an output message.
  101.  
  102. Otherwise MIDIFIND writes following messages:
  103. filename.mid: text that contains the searched word or phrase
  104.  
  105. [8] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  106.  
  107.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  108.           contains all my dos/unix midi programs
  109.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  110.  
  111. [9] EXAMPLES
  112.  
  113. get all textual information of a midi file sample.mid:
  114.  
  115. command> midifind * sample.mid
  116. sample.mid: B Voice
  117. sample.mid: B high
  118. sample.mid: B bass
  119. sample.mid: B Drums
  120.  
  121. find copyrights in all midi files:
  122.  
  123. command> midifind copyright *.mid
  124. filename.mid: Copyright 1993 by ...
  125.  
  126. and 
  127.  
  128. command> midifind (c) *.mid
  129. filename.mid: (c) 1993 by ...
  130.  
  131. find what great midi files are by M. Walthius:
  132. command> midifind M*Walthius
  133. ECHOES1.MID: by M. Walthius
  134. DREAMING.MID: Copyright 1995 by Michael Walthius
  135. DREAMING.MID: by M. Walthius
  136. GATEDOOM.MID: Copyright 1995 by Michael Walthius, all rights reserved.
  137. GATEDOOM.MID: by M. Walthius
  138. CYBRBEAT.MID: by M. Walthius
  139. DRKSHORE.MID: "Incident at Dark Shores"  Copyright 1995 by M. Walthius, All Rights Reserved.
  140. DRKSHORE.MID: M. Walthius.
  141. TRAVELS.MID: Composed by M. Walthius
  142. TRAVELS.MID: by M. Walthius
  143. FNKNGRVN.MID: FUNKENGRUVEN by M. Walthius
  144.  
  145. [10] CHANGES
  146. v1.0 to v1.1:
  147.   * bug when using wildcards and path (produced random filename that cannot be found)
  148.   * hiding trivial names like instrument names
  149.  
  150. v1.1 to v1.2:
  151.   * long filename support for DOS 7.0/Windows95
  152.